home *** CD-ROM | disk | FTP | other *** search
/ Delphi 2.0 - Programmer's Utilities Power Pack / Delphi 2.0 Programmer's Utilities Power Pack.iso / m_to_r / pprev101 / prntprev.txt < prev    next >
Encoding:
Text File  |  1996-09-15  |  5.0 KB  |  130 lines
  1.  
  2. NOTE: This document is also provided as a Windows 3.1 Write file with
  3.       formatting.
  4.  
  5. *******************************
  6. *** Print Preview Component ***
  7. *******************************
  8.  
  9. Adds *easy* Print Preview capability to any Delphi Application
  10.  
  11.  
  12. Features:
  13.  
  14. Print Preview supports:
  15.     - Zoom from 10% to 5000%
  16.     - Zoom tool allows zoom in/out on a specific location
  17.     - Hand tool allows easy panning across the page
  18.     - One Page or Two Page displays
  19.     - Portrait or Landscape page orientation
  20.     - Printing Status display with CANCEL and cooperative multi-tasking
  21.     - Tool Tips & Hints for iconic buttons
  22.     - Status bar displays page, zoom level, and hints
  23.     - Customizable Grid verifies margins & layout
  24.  
  25. Programmer Benefits:
  26.     - One set of routines for Printing & Previewing
  27.     - Supports all TCanvas routines (except for PenPos & Pixels)
  28.     - Built-in routines eliminate round-off errors for pagination
  29.     - Automatically clips non printable area on Preview
  30.     - Returns the true physical page size (not just printable area)
  31.     - Returns all printer info (page size, printable area, pixels/inch,
  32.           etc)
  33.     - Conversion routines for inches to printer units
  34.     - All Preview Screen scaling performed automatically
  35.     - Programmer can implement Exception Handling to catch Print
  36.           Preview Errors
  37.     - Simple & Advanced print pagination is supported
  38.     - Customizable Preview Form
  39.         - Show/hide buttons
  40.         - Change the title
  41.         - Select min, max, and step for Zooming
  42.         - Set initial settings
  43.  
  44. Fully functional - not crippled in any way
  45.  
  46. The unregistered version of this component has an "About" box on the Preview
  47. screen that indicates the component has not been registered.
  48.  
  49.  
  50. Installation
  51.  
  52. 1. Copy the files PRNTPREV.DCU, PRNTPREV.DCR, *.DFM, and *.RES to your
  53.    DELPHI\LIB directory.
  54. 2. From the "Options" Menu, select "Install Components".  Press the "Add"
  55.    button, and then the "Browse" button.  Go to the LIB directory, and
  56.    select UNIT file types (*.dcu).  Then select PRNTPREV.DCU and press "OK".
  57.    Then press "OK" for the Install Components dialog box.
  58. 3. When Delphi is done compiling there will be a new component in your
  59.    "Samples" palette called PrintPreview.
  60.  
  61. Testing the Print Preview Component
  62.  
  63. A sample project is already provided.  Open the project called TESTPREV.DPR
  64. and run it.  Note:  you must install the Print Preview component before
  65. opening and running the test project.
  66.  
  67. When the program starts, you are given four page tab control (Text, Table,
  68. Graphics, and MultiPage).  Select each page and press the Print Preview
  69. button to view the demo.  You may change some of the options for each of the
  70. examples.
  71.  
  72. Once inside the Print Preview screen, you can zoom in or out (with the
  73. buttons or by clicking with the mouse).  The Hand tool can be used to move
  74. the page around (only if it is larger than the screen).  You can select a
  75. one page or two page view.  In the MultiPage example, you can advance to
  76. the next page, or move back.
  77.  
  78. Advanced
  79.  
  80. To use the Print Preview component in your own projects, simply drop the
  81. component on your form.  Then register the three events (Begin Print, End
  82. Print, and Print Page) with your own routines.  Refer to the Test project
  83. sample code, or to the PRNTPREV.INT file for technical details on
  84. interfacing with the component.  The sample project code shows 90% of what
  85. can be done with the component.
  86.  
  87.  
  88. Shareware Registration
  89.  
  90. This component is shareware, and is distributed to be used for a limited
  91. trial period of 30 days.  You are free to copy and distribute this software
  92. in unmodified form.  After the 30 day period the software should be
  93. registered or removed from the user's system.  If the component is to be
  94. included in a commercial or government application, it must be registered
  95. (i.e., paid for).
  96.  
  97. The registered version of the component offers two additional benefits:
  98. 1) the ability to hide the "About" box on the Preview screen, or replacing
  99. it with your own custom button & procedure; and 2) technical support via
  100. email or phone (you pay the long distance though).  Source code is also
  101. available to registered users.
  102.  
  103.  
  104. Pricing and Ordering Information
  105.  
  106. Registered Print Preview is U.S. $20.  Full source code is an additional
  107. $20.  If you need a 3.5" disk mailed to you, an additional $4 is charged for
  108. shipping and handling.  Preferrable, if you have email I can just email you
  109. the registered component (and source code).
  110.  
  111. Send a check or money order to:
  112.     Print Preview Component Software
  113.     Care of:  Ben Ziegler
  114.     210 E. Fairfax St #624
  115.     Falls Church, VA  22046
  116.  
  117. Make checks payable to "Ben Ziegler."  When you register I will send you
  118. my phone number for technical support.  Note that I can only take calls
  119. after work.
  120.  
  121.  
  122. Questions, Comments, and Suggestions
  123.  
  124. I'd love to hear any questions, comments, or suggestions you may have (and
  125. yes, even bug reports).  I can also be reached on email at benz23@aol.com.
  126.  
  127.  
  128. Thanks for trying my Print Preview component!  Delphi Rules!!
  129. -Ben
  130.